home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / nfsrc21.zip / NANFOR.RMK < prev    next >
Text File  |  1992-10-20  |  21KB  |  574 lines
  1. /*
  2.  * File......: NANFOR.RMK
  3.  * Date......: $Date:   20 Oct 1992 01:18:38  $
  4.  * Revision..: $Revision:   1.16  $
  5.  * Log file..: $Logfile:   C:/nanfor/src/nanfor.rmv  $
  6.  * 
  7.  * Modification history:
  8.  * ---------------------
  9.  *
  10.  * $Log:   C:/nanfor/src/nanfor.rmv  $
  11.  * 
  12.  *    Rev 1.16   20 Oct 1992 01:18:38   GLENN
  13.  * Adjusted librarian's path macros.
  14.  * 
  15.  *    Rev 1.15   16 Oct 1992 00:18:42   GLENN
  16.  * Deleted ATPROMPT.PRG.
  17.  * 
  18.  *    Rev 1.14   16 Oct 1992 00:11:16   GLENN
  19.  * Added DBFHANDL.ASM, DBTHANDL.ASM, DISPCNT.ASM, NTXHANDL.ASM, and
  20.  * SETKEYS.ASM.  Removed TMENU.ASM.
  21.  * 
  22.  *    Rev 1.13   13 Oct 1992 20:41:38   GLENN
  23.  * Remove TMENU.*; Ted is revamping his @ prompt/menu to replacement.
  24.  * 
  25.  *    Rev 1.12   03 Oct 1992 02:15:02   GLENN
  26.  * Deleted ORIGIN.ASM and replaced with ORIGIN.C.
  27.  * 
  28.  *    Rev 1.11   03 Oct 1992 02:09:18   GLENN
  29.  * Got rid of reference to fttext.h; Steve Larsen's new mods don't
  30.  * require it.
  31.  * 
  32.  *    Rev 1.10   29 Sep 1992 00:42:14   GLENN
  33.  * Added support for explicit pointers to include files; and documented
  34.  * it.  Reset the "rebuilding environment" to a directory structure not
  35.  * so deeply nested.
  36.  * 
  37.  *    Rev 1.9   28 Sep 1992 23:18:02   GLENN
  38.  * Updated the documentation to reflect the current status of the
  39.  * CompuServe forum.  Removed test driver support (this wouldn't have
  40.  * ever worked anyway).  Reset the default variables for the librarian's
  41.  * environment, as is his sacred right.
  42.  * 
  43.  *    Rev 1.8   22 Aug 1992 16:51:04   GLENN
  44.  * Added PVID.PRG.
  45.  * 
  46.  *    Rev 1.7   01 Jul 1992 02:20:20   GLENN
  47.  * Added SLEEP.PRG.
  48.  * 
  49.  *    Rev 1.6   01 Jul 1992 01:24:10   GLENN
  50.  * Added SETLASTK.ASM.
  51.  * 
  52.  *    Rev 1.5   16 Aug 1991 00:02:38   GLENN
  53.  * MADD.PRG and MONTH.PRG dependency lines were written incorrectly
  54.  * so these objects were being built whether they changed or not.
  55.  * Fixed.
  56.  * 
  57.  *    Rev 1.4   15 Aug 1991 23:09:02   GLENN
  58.  * Forest Belt proofread/edited/cleaned up doc
  59.  *
  60.  *    Rev 1.3   17 Jul 1991 22:50:50   GLENN
  61.  * Added a couple last minute sources
  62.  * 
  63.  *    Rev 1.2   14 Jun 1991 20:28:30   GLENN
  64.  * Moved SHADOW.OBJ from MASM section to TASM section
  65.  * 
  66.  *    Rev 1.1   14 Jun 1991 19:58:38   GLENN
  67.  * Removed NOVCONS.OBJ pending some bug fixes.
  68.  * 
  69.  *    Rev 1.0   14 Jun 1991 18:46:46   GLENN
  70.  * Initial revision.
  71.  *
  72.  */
  73.  
  74.  
  75. /* ----------------------------------------------------------------------
  76.    The Nanforum Toolkit Master Makefile     READ THIS BEFORE USING!!!
  77.    ----------------------------------------------------------------------
  78.   
  79.    This makefile will allow you to use RMAKE, provided with every
  80.    Clipper 5.01 package, to maintain your own copy of the Nanforum
  81.    Toolkit.  It is also an example of one way to use RMAKE on a
  82.    large project.  This is the exact copy used by the Nanforum Toolkit
  83.    librarian.
  84.   
  85.    To use it, you must first understand what it does, and what your
  86.    limitations are.  A discussion of MAKE utlities is beyond the scope
  87.    of this comment; read the Clipper documentation, or the Norton Guide
  88.    file, for more information on RMAKE.
  89.   
  90.    *** Compilers and Assemblers you need
  91.   
  92.    Note that currently, Nanforum Toolkit sources are written in
  93.    Assembly language, Clipper, and C.  Within the realm of assembly
  94.    language, our contributors have submitted code that is designed
  95.    for Borland's Turbo Assembler (TASM) and Microsoft's Macro Assembler
  96.    (MASM).  So, right now, in order to do a perfect re-build of 
  97.    the Nanforum Toolkit, you must have these tools:
  98.   
  99.         Microsoft C (v5.1 or later)
  100.         Microsoft Macro Assembler (v 5.1 or later)
  101.         Borland Turbo Assembler
  102.         Nantucket Clipper v5.01 or later
  103.  
  104.   
  105.    If you know much about assembly language, you can convert MASM
  106.    sources to TASM and vice versa, but that is up to you.
  107.   
  108.    *** Library Utility
  109.   
  110.    In addition, you must have a library utility.  Microsoft supplies
  111.    LIB.EXE with its Compiler products, for example.  LIB will work
  112.    fine with this makefile.  Note that we assume a command line syntax
  113.    for library utilities that works like this:
  114.   
  115.         lib <libname> -+objname
  116.   
  117.    Note the "-+" directive, indicating "replace module."  If your
  118.    library utility does not support this syntax on the command line,
  119.    then you will have to edit the relevant lines in the makefile.
  120.  
  121.    A version of LIB.EXE can be found on CompuServe.  Download S12776.ARC
  122.    from the MSL forum.
  123.   
  124.    *** Assumptions about your environment
  125.   
  126.    NANFOR.RMK makes just a few assumptions about your environment:
  127.   
  128.               Assumption            What to change if we're wrong
  129.               ----------            -----------------------------
  130.   
  131.    Microsoft C is being             Look for the .C source inference
  132.    used                             rule below, and change it to *your*
  133.                                     compiler, making sure your switches
  134.                                     are correct.  Note that some source
  135.                                     may not compile without MSC, so edits
  136.                                     may be required.  Try to use MSC.
  137.                                     This is also where you will change the
  138.                                     makefile to whatever *you* call your
  139.                                     C compiler (CL for Microsoft C 5.1.)
  140.   
  141.    Microsoft Assembler              Look for all occurences of MASM in
  142.    executable is called             this makefile and change them to
  143.    MASM.EXE                         whatever *you* call MASM.
  144.   
  145.    Borland's Turbo Assembler        Look for all occurences of TASM in
  146.    executable is called             this makefile and change them to
  147.    TASM.EXE                         whatever *you* call TASM.
  148.   
  149.    Clipper compiler executable      Look for the .PRG source inference
  150.    is called CLIPPER.EXE            rule below, and change it to whatever
  151.                                     *you* call Clipper.
  152.   
  153.   
  154.    *** Customizing the Makefile
  155.   
  156.    We have tried not to assume anything about your environment except
  157.    what is described above.  To achieve that flexibility, you must
  158.    check and set some macros that can be found just below this
  159.    documentation.  They are:
  160.   
  161.         l         Path to the resulting library (i.e., \nanfor)
  162.         o         Path to where .obj files should be put (i.e., \nanfor\obj)
  163.         s         Path to where the source code is found (i.e., \nanfor\src)
  164.        c5         Path and name of Clipper 5.0 compiler
  165.        c5g        Clipper 5 option line for include files (see below)
  166.        ma         Path to Microsoft Macro Assembler .EXE
  167.        ta         Path to Turbo Assembler .EXE
  168.        mc         Path to Microsoft C 5.1
  169.        mcg        Microsoft C option line for include files (see below)
  170.        ml         Path and name of library utility (i.e., \bin\lib)
  171.   
  172.     Note that directory paths should *not* end in a backslash.
  173.     If you like to keep your .obj and source files in the same
  174.     directory, simply point the paths to the same place.
  175.  
  176.     Be careful not to nest your "rebuilding environment" (see below) 
  177.     to deep; you could end up creating very long command lines that 
  178.     will exceed DOS limits.  
  179.  
  180.     *** How include files are handled
  181.  
  182.     The librarian maintains a few versions of Clipper on his disk
  183.     at any one time, as well as one or two versions of various 
  184.     C compilers.  As time went on, he realized that the SET 
  185.     INCLUDE= and SET LIB= environment variables were somewhat evil.
  186.     For example, toolkit v2.1 is supposed to be built with the 
  187.     exact includes supplied by Computer Associates for 5.01a, but the 
  188.     librarian's INCLUDE envar points to the 5.0 includes.  Resetting
  189.     these variables is easy but if one forgets, there is a potential
  190.     for version confusion.
  191.  
  192.     To eliminate confusion over where the globals are, the following
  193.     was decided:
  194.  
  195.         All include files shall be pointed to explicitly using
  196.         compiler command line options, and if possible, the 
  197.